home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 24 / Amiga Format AFCD24 (Feb 1998, Issue 108).iso / -in_the_mag- / emulation / amiga / uae-0.7.0b2 / docs / readme.beos < prev    next >
Text File  |  1998-01-20  |  5KB  |  126 lines
  1. This file documents the details relevant to the Unix versions of UAE. General
  2. information can be found in the file "README"
  3.  
  4. System requirements
  5. ===================
  6.  
  7. UAE will run on any System with BeOS Preview Release 2.
  8.  
  9.  
  10. Starting UAE
  11. ============
  12.  
  13. UAE should only be started from the Shell.
  14.  
  15.  
  16. Compilation
  17. ===========
  18.  
  19. If you want to rebuild UAE, unpack the source archive to an appropriate
  20. directory (e.g. /boot/home). The simple way to proceed is to type "configure;
  21. make". After that has completed you should have a working BeOS version
  22. of UAE. Ignore warnings if you get them.
  23.  
  24. However, you should probably have a look at some of the compile-time options
  25. found in "config.h" before you do this. There are some things you can change
  26. there so that the resulting executable will perform better on your machine.
  27. Each of the options in that file has a description. You can edit config.h to
  28. suit your needs; and then do "configure; make" afterwards.
  29.  
  30.  
  31. Graphics
  32. ========
  33.  
  34. The BeOS version of UAE currently only supports a color depth of 8 bits.
  35. You should set the color depth of the workspace you're running UAE in to
  36. 8 bits/pixel for maximum speed.
  37.  
  38.  
  39. Sound
  40. =====
  41.  
  42. The sound currently doesn't work very well. You must start UAE with "-S 2"
  43. or "-S 3" to get sound.
  44.  
  45.  
  46. Keyboard
  47. ========
  48.  
  49. Some special keys of the Amiga keyboard are mapped as follows:
  50.  
  51.   (Amiga)   -> (Be)
  52.   Help      -> Insert
  53.   Amiga     -> Alt
  54.   Alt       -> Wind*ws keys
  55.   Left Alt  -> End
  56.   Right Alt -> Right Control, Page Down
  57.   '(' (NP)  -> Home
  58.   ')' (NP)  -> Page Up
  59.  
  60.  
  61. Mouse and joystick emulation
  62. ============================
  63.  
  64. The BeOS version has one problem: There are two mouse pointers, the
  65. X mouse pointer and the Y mouse pointer. You can work that way, but you get
  66. confused quickly.
  67.  
  68. The solution in previous (0.6.8 and before) versions of UAE was a small piece
  69. of code that looked at the position of sprite 0 on the screen and tried to
  70. generate mouse movements in an emulated hardware port. That worked reasonably
  71. well, but had several problems.
  72.  
  73. The new solution is to use a small Amiga program which is called "mousehack".
  74. You will find this in the "amiga" subdirectory. Put it into the directory that
  75. you use for harddisk emulation so that you can run it from the emulator. Then
  76. put the command "run >NIL: mousehack" at the top of your startup-sequence. UAE
  77. will detect when this program is running and use the improved mouse pointer
  78. positioning method (don't run this program on old versions of UAE).
  79.  
  80. If the program is not running, you get the old behaviour - almost. By default,
  81. the emulator will no longer try to keep Amiga and BeOS mouse pointers at the same
  82. position, because that led to problems in the past. You can toggle this
  83. behaviour with F12.
  84.  
  85. (If you just added "run mousehack" to your startup-sequence, that would have
  86. the effect that the initial CLI window would be impossible to close.
  87. Unfortunately, redirecting output to >NIL: disables all error messages that
  88. mousehack can give you - so if it does not work, try running it by hand
  89. without the >NIL: redirection.)
  90.  
  91. If you find a program in which the mouse pointer does not move at all if you
  92. use the BeOS version, start that program with mousehack _not_ running
  93. (Magnetic Scrolls adventures are known to need this, for example).
  94.  
  95. A joystick in port 1 (the lower port) is supported. UAE calibrates the
  96. joystick automatically. Turn it a few times on startup to get the calibration
  97. done. 
  98.  
  99.  
  100. Harddisk emulation
  101. ==================
  102.  
  103. Please read the appropriate sections in the file "README" on how to use the
  104. filesystem emulation. There are a few BeOS-specific things about it, though.
  105.  
  106. If you want to execute files located on a native filesystem, they need to have
  107. the x permission bit set. That can be done in the Bash by "chmod +x file" or
  108. in AmigaDOS with "protect file rwed".
  109.  
  110. You should set aside a whole directory tree for AmigaOS files, and not use it
  111. from BeOS in any way if you can avoid it. Changing permissions/owners,
  112. creating symbolic links and doing other stuff that AmigaOS does not know about
  113. is a good way to confuse the emulator and the emulated software. E.g. it's
  114. possible to have a symlink pointing at a mounted CD-ROM. The emulator would
  115. see that as a directory inside which it gets "read only filesystem" errors,
  116. and wouldn't know what to do about it. Avoid this sort of thing. It's best to
  117. start with an empty harddisk emulation directory and install software there
  118. only from within the emulation.
  119.  
  120. The following setup can also lead to problems:
  121.  
  122.   -m dh0:/foo -m dh1:/foo/bar
  123.  
  124. Please take care that the filesystems you mount don't overlap each other
  125. (another great reason not to use symbolic links within them).
  126.